home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 6: Level 6 / 17 Bit - Level 6 (1998)(Epic Marketing)[!].iso / !new-os! / executivev2.10 / lcd / lcdcpu.doc < prev    next >
Text File  |  1996-10-29  |  5KB  |  100 lines
  1. lcdcpu.doc
  2.  
  3. NAME
  4.      lcdcpu - display a CPU meter on external LCD
  5.  
  6. VERSION
  7.      V1.1 - 21.10.96
  8.  
  9. SYNOPSIS
  10.      lcdcpu Interval/N,Toggleint/N,Clock/S,Mem/S,MemBar/S
  11.  
  12. REQUIREMENTS
  13.      - the "Executive" task scheduler. lcdcpu uses Executive's
  14.        "SysInfo.library" to read current CPU load.
  15.      - the "LCDaemon" hard- and software project. Minimum LCDaemon version
  16.        is V1.6, previous versions didn't support programmable characters.
  17.  
  18. DESCRIPTION
  19.      I got the idea for lcdcpu from an SGI machine on CeBit where they had
  20.      a small LC display to show the current load of the 16 or so CPUs :-)
  21.      As the "LCDaemon" project (available on AmiNet in hard/hack) allows to
  22.      connect an LC display to the Amiga's parallel port, I decided to
  23.      complement the Executive task scheduler package (on AmiNet as well)
  24.      and LCDaemon to give a similar display. Optionally it can also show a
  25.      clock and/or memory meter.
  26.      Parameters are as follows:
  27.        - Interval/N:  interval between two display updates in seconds
  28.        - ToggleInt/N: number of updates to pass before toggling between
  29.                       clock and memory display
  30.        - Clock/S:     show a clock below the CPU bargraph
  31.        - Mem/S:       show free memory in KB, numeric
  32.        - MemBar/S:    show free memory as bargraphs
  33.      If both Clock and Mem/MemBar are specified, lcdcpu will simply toggle
  34.      between both. Default is to toggle every third display update if
  35.      nothing else was specified with ToggleInt/N. Giving TglInt/N alone
  36.      makes lcdcpu assume you want both Clock/S and Mem/S.
  37.      If you don't want either of them, some percent values for the
  38.      bargraph will be printed in the second line. 
  39.  
  40. BUGS
  41.      - It seems in non-exclusive display access mode (display may be shared
  42.        by multiple programs, which is a feature of LCDaemon I do not want
  43.        to switch off) it's not possible to make the cursor invisible.
  44.        Looks quite ugly :-(
  45.      - Can only use the upper two lines of multi-line LCDs
  46.      - Crashes if Executive is not running. This seems to be a
  47.        SysInfo.library problem though, especially because its signal
  48.        notficaion system is also buggy.
  49.        (Last note: Executive V2.0b has the notification bug fixed [thanx
  50.        Petri!], I haven't checked if the crash problem is fixed as well
  51.        though.)
  52.  
  53. HISTORY
  54.      V0.9      (09.06.96)     First release
  55.  
  56.      V1.0      (27.08.96)     Oops...there actually *were* bugs :-)
  57.                               This is in fact almost a complete rewrite.
  58.                               - Implemented programmable character support
  59.                                 for a nicer bar.
  60.                               - removed some unnecessary sysinfo.library
  61.                                 calls when using update intervals > 1.
  62.                               - Fixed possible problems with VMem (some
  63.                                 structures which should have been "static"
  64.                                 were not)
  65.                               - sysinfo.library's name has changed to
  66.                                 "SysInfo.library" :-(
  67.  
  68.      V1.01     (29.08.96)     - Some source cleanup, also made the
  69.                                 executable smaller.
  70.                               - One unnecessary custom char was allocated
  71.                                 on the LCD. Fixed.
  72.                               - On at least 18 characters wide displays,
  73.                                 the clock display now shows seconds.
  74.                               - More meaningful errormessages & returncodes
  75.  
  76.      V1.02     (30.08.96)     - Specifying TglInt/N is now sufficient to
  77.                                 activate both clock and memory display.
  78.  
  79.      V1.03     (19.10.96)     - Intervals of 0 caused a division-by-zero
  80.                                 crash :( Fixed. Thanx to MaXiM for the
  81.                                 bugreport!
  82.                               - minor changes in errormessages
  83.      V1.04     (20.10.96)     - Fixed a (harmless) enforcer hit in the
  84.                                 memdisplay routine caused by bogus
  85.                                 sprintf() parameters.
  86.      V1.1      (21.10.96)     - Implemented bargraph display of free memory
  87.                                 (parameter MemBar/S)
  88.  
  89.  
  90. TODO
  91.      - more Executive system statistics maybe...
  92.  
  93. AUTHOR
  94.      Matthias Bethke
  95.      Giessener Strasse 31
  96.      35457 Lollar
  97.      Germany
  98.      postmaster@sweetdreams.lahn.de
  99.      Matthias Bethke@39:176/208.0
  100.